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GENERAL 


The Burroughs 81700 HASP program enables a 81700 to operate in 
conjunction with an I8M 05/360» or 05/370» performing the functions 
normally associated with an off-line support computer. The IBM HASP 
system of automatic spooting and priority scheduling supports an 
untimited number of remote peripherals operating simultaneously» 
via several classes of telephone lines. 


Through the use of the HASP Remote Job Entry feature» a users 
‘located perhaps thousands of miles from a particular System 360 or 
370 instatlation» can utilize the capabilities of the installation 
much as if the centrat computer were located at the remote site. 
The unit record devices (card readers» punches and printers) at the 
remote station are togicalty operated by HASP as if they were locat 
readerss printers» punches» and consoles» so that HASP can 
Simultaneously» while operating alt tocal unit record devices» read 
jobs from several remote readers into the queue of jobs awaiting 
' processing and output to several remote printers and/or punches 
results of previously entered jobs which have completed execution. 


A special set of programs have been written for the B1700 which can 
be considered a togicat extension of the HASP system. These 
programs perform the same functions as the remote terminal program 
for the IBM 360/20 computer. The [8M 360/20 remote terminat program 
was selected as the model remote terminal in order to implement the 
“multi-leaving™ feature of HASP. 


White the I8M 360/20 remote terminai program is a stand-alone 
programs the 81700 HASP/RJE programs run under control of the B1700 
MCP. This gives the 81700 HASP/RJE all the resources found in a 
computer controlled by an operating system. For information on 
operation and facilities of the 81700 MCPs» please refer to the 
B1i700 Software Operational Guide (SOG). 
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This product specification consists of four sectionss each with 
self-contained index and table of contentse They are; 


Section 
Section 
Section 
Section 


\ ae 
Il 
It! 
IV 


Remote Job Entry CHASP) 


HASP Environment CHASP/SPOOL) 
TESTBSC 
BURRBSC 
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SYSTEM ARCHITECTURE 


The B1700 Remote Job Entry software consists of two programss HASP 
and HASP/SPOOL. The remote terminal programs HASP»s is responsible 
for maintaining the line disciptine with the host system and 
Managing the tocalt 1/0 of the remote site during a RJE session. 
HASP/SPOOL> the off-line input/output program which creates input 
spools and produces output spools» is. described more fully in 
HASPC Section II). 


There are two modes of operation for the remote: sites SPOOL and 
DIRECT. | 


SPOOL MODE 


SPOOL mode consists of three distinct phases. 


Phase #1: Input spool creation Coff-line) with HASP/SPOOL. 
Phase #22 Input spool transmission and receipt of output spool - 
" s Constine) with HASP. 
Phase #3: Output spool printing and punching Coff- line) with 
HASP/SPOOL. 


Note: — “On-line” is defined as? connections via data comms 
to the host HASP system. 


"Off-line™ is defined as? no connection. with the 
host HASP system. — 
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SPOOL Phase #1 


The input spool is created off-line by HASP/SPOOL in order. to reduce 
System requirements during the actual HASP/RJE session with the 
host. Cards are read» compressed» blocked and stored in ae disk 
file. Many card decks may be concatenated to form one input spool 
file. If more than one input spool disk file is to be transmitted 
during a sessions each must have a unique namee The spoot created 
by HASP/SPOOL is ltabelled "HASP/CARDS”. A subsequent execution of 
HASP/SPOOL wilt create another file Labelled “HASP/CARDS*. In order 
to retain both files» the first one must. be changed from. 
WHASP/CARDS”™ to another name. Refer to 81700 S0G for disk fite 
tabel changing informations Phase #1 is more fully described in 
Section II CHASP/SPOOL) of this document. | 
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SPOOL MODE 


Phase #1 INPUT SPOOL CREATION 
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SPOOL Phase #2 


Phase #2 consists of executing HASP» accepting appropriate run time 
parameters Crefer to RUN TIME PARAMETERS)» establishing 
communications transmitting input spools» and receiving output from 
the host system. After communication is established» HASP signs on 
and enters a handshaking mode with the host. To transmit an input 
spool files the operator merely starts an input reader by entering 
the tocal HASP command <mix # of HASP>AX.SR1 or <mix # of 
HASP>AX.SR1i <filename>» where <filename> is an optional name of the 
input spool if the input spool is not tabeled “HASP/CARDS*. Refer 
to LOCAL COMMAND SUBMISSION for .SR1 format. 


After verifying that the input spoot was created with the same run 
time parameters as HASP» a message is displayed “READER 1 OPEN™ and 
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the file is transmitted. After the file has been transmitted» HASP 
displays "READER 1 CLOSED". If another spoot is to be transmitted» 
the operator repeats the above procedure. 


Any output received during the spool mode HASP/RJE session is 
written in its btocked and compressed from into the output spool 
disk . files HASPOUT. HASPOUT is initially tabeiled "HASP/PRINTO1%. 
Whenever HASPOUT is closed and reopened during the HASP/RJE 
session © (see LOCAL COMMAND SUBMISSION)» the tabet for HASPOUT is 
‘¢ncremented by 1. | , 


The operator may communicate with the host system by entering 
console messages to HASPS eeger» <mix # of HASP>AXS0M<n>» “THIS IS 
A MESSAGE" would cause HASP to transmit the entire string following 
the <mix # >AX until ETX is encountered... <n> is the remote ID. 


Any SPO command whose first characters is a “%." is interpreted as a 
focal command intended for HASP (see LOCAL COMMAND SUBMISSION). 
Termination of Phase #2 is done by entering <mix # of HASP>AX.CLOSE 
on the console which causes HASP to sign off» close the output file 
and print a summary statistics report for this session. 
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Phase #2 SPOOL TRANSMISSION 
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SPOOL Phase #3 


Phase #3 prints and punches data from the output spool fite. The 
operator executes HASP/SPOOL and setects the output mode of 
Operation. HASP/SPOOL reads the output spoot disk file catted 
 PHASP/PRINTO1%» debltocks and decompresses the records» and then 
prints or punches the output. This is all done off-line to tessen 
System requirments during the actual HASP/RJIE session with the 
host. Phase #3» is more fully documented in Section Il 
CHASP/SPOOL). | 


SPOOL MOOE 


Phase #3 OUTPUT SPOOL PRINTING AND PUNCHING 
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DIRECT MODE 


In DIRECT mode» HASP maintains the line discipline with the host and 
directly handles alt tocal 1/0 (card reader» card punches line 
printer and SP0) at the remote site. 


The DIRECT mode is initiated by executing HASP and entering 
appropriate parameters for the patticutar remote site Crefer to RUN 
TIME PARAMETERS for formats). Input can be sent to the host by 
entering the Local command -SR1 followed optionally by a file name. 
The format for -SR1 is described in command submission. 


After receiving a .SR1 commands HASP will request permission ta send 
from the host» open the input file and display "READER 1 OPEN™. Alt 

input is read» compresseds blocked and transmitted to the host 

until end of file is detected. Upon detecting end of file in the 

card files HASP will transmit an end of file message to HASP and 

display "READER 1 CLOSED". 


Att. output received is decompressed and output to either printers 
punch or SPO. 7 


The operator can communicate with the host via HASP by entering <mix— 
# of HASP>AXSDM<n>» “THIS IS A MESSAGE*. HASP sends everything 
following the AX untit an ETX is encountered. The session can be 
terminated by sending a sign off card or by entering <mix # of 
HASP>AX.CLOSE. Either one will cause HASP to sign offs print a 
summary statistics reports and then go to end of job. 


Any SPO command whose first character is a “.” is interpreted as a 
local command and intended for HASP. (see LOCAL COMMAND SUBMISSION) 


<n> is the Remote’s ID. 
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BLOCK DIAGRAM OF HASP-DIRECT MODE 
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SYSTEM REQUIREMENTS 


The system requirements for B1700 HASP/RJE are:. 


MCPLII 

&8K Bytes Main Memory 
80~ or 96-Column Card Reader 
120- or 132-Position Printer | 
seo. 
Disk (Cartridges Disk Pack or Head-per-Track) 
Single Line or Muiti Line Control 
EBCDIC Bisync Adapter 

80- or 96-Coltumn Punch Coptional) 


Notes IBM OS object code reading and punching is supported on 
80 and 96 column equipment for MCPII 5.1 or higher. 


Larger memory sizes are required when multi-programming other jobs 
with HASP remote programs. 
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RUN TIME PARAMETERS 


Each remote B1700 HASP/RJE system wilt have unique run time 
parameters,» i.e.» buffer size» remote ID» compression type» etc. 
that are dynamically set at beginning of job. In the past these 
HASP variables were compiled into a remote program and any change 
in the remote necessitated a recompilation of the remote program. 


Currentlys howevere HASP has a List of default run time parameters 
that the operator can keep or override at the start of a HASP/RJE 
session. . 


* 


At the beginning of jobs HASP will interrogate program switch zero 
for a zero value. If a zero vaiue is found (meaning switch was not 
set by operator when executing HASP)»5 HASP will attempt to read a 
disk file tabelted "HASP/PARMS® to obtain the appropriate run time 
parameters for this HASP/RJE session. If the "HASP/PARMS* file is 
found the syntax of the parameters tn the file is checked. If the 
parameters are syntax error “freee HASP proceeds to the 
establishment phase of the HASP/RJE session. To bypass the search 
for the “HASP/PARMS™ file on disks the operator should execute HASP 
as fottows: 


EX HASP SH 0 @Fa; 


“HASP/PARMS"™ disk file can be created by "DMPALL™ or any suitable 
cardetosdisk program. Refer to PARAMETER DEFAULTS AND FORMATS for 
parameter defaults and formats. 


If any of the following occurs: 


aed SH 0 is set 
bed “HASP/PARMS™ disk file not present | 
Ce). *HASP/PARMS® disk. file contains an invalid parameter 
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HASP witt display the message: 


USE DEFAULT PARAMETERS? 


Run time parameter entry -occurs at this time. The acceptable 
responses to "USE DEFAULT PARAMETERS?” are? , | | 


<mix # of HASP>AXYES : | “YES" means use of all the 
default parameters. Refer to 
PARAMETER DEFAULTS AND 

FORMATS for defaults. 


<mix # of HASP>AXR | . “R* means read run time 
parameters from a card fite 

“PARMS" labeled 

"HASP/PARMS*. Refer to 


PARAMETER LIST ENTRY for 
format of parameter file. 


<mix # of HASP>AX({( Parameter List] © (Parameter List} is a tist 
of run time parameterse 
Refer to PARAMETER LIST 
ENTRY for format — of 
parameter list. 


<mix # of HASP>AX/*SIGNONeos "/eSIGNONe ee” is the exact 
format of the first 72 
columns of a SIGNON card. 
This entry will override the 
default SIGNON card and any 
IOs or /*SIGNON found in 
Subsequent parameter entry. 
After HASP has accepted the 
“Signon entrys the operator 
can continue with a YES» Re 
or (Parameter | List) 
response. 


If none of the above are entereds an Pareneeee RESPONSE» TRY AGAIN™ 
message eee be displayed. . 
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PARAMETER DEFAULTS AND FORMATS 


The table below tists default run time parameters. These parameters. 
will be used if reply in RUN TIME PARAMETERS. is "YES". Specific run 
time parameter defaults are overridden by entry of that parameter — 
in the (Parameter List] or by the presence of that parameter in the 
card file “HASP/PARMS". Omission of a parameter causes the default 
to be used. . . 


Default parameters should not be set. For example» SPOOL means SPOOL 
mode of operation and the absence of SPOOL means DIRECT mode of 
operation since DIRECT is not a valid parameter. 


RUN TIME. PARAMETER DEFAULTS 


Parameter Meaning | | Defauit 


SPOOL SPOOL mode of operation DIRECT mode of operation 
LEASED Leased Line — Switched Line 
PROSLEM Run with the DEBUG file _ Run with the DEBUG 
‘ open | file closed 
/*SIGNONes. Signon card image REMOTE1 with no 
password 
10=<n>  Remote's ID» where <n> is a 10=1 


one or two digit number. | 

If the ID is only one 

digit» do not precede it 

with a leading zero. Correct 
ID=1s incorrect [D=O1L. — 


BUFFER=<n> Teleprocessing buffer sizes BUFFER=400 
where <n> is 3 or 4 digits : 
from 132 to £095. Note <n> 
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must match the buffer size 

of the host system and 

dynamic memory size must be 
changed if default is not 

used (See DYNAMIC MEMORY SIZE). . 


ADDRESS= a | a 
P3CzAs Address of bisync ADDRESS=7 212203 
adapters where: 


P = one digit port # (0-7) 


C = one or two digit 
channel # €0-15) 


A = one or two digit 
adapter # (0-15) 


Note: Ending colon is 
required. 


NONTRANS Non-transparent text =~ Transparent text 


PRINTER=<n> Printer tine sizes where PRINTER=132 
<n> is = 132 or 120. <n> must : 
match size of remote 
printer line and 
generated size in host. 


QUEVE=<n> Number of buffers QUEUE=2 
'. allowed to be queued 
internally before host 
is told to suspend 
transmissione <n> is 
a vatue from 2 to 4. 


COMP. TYPE=<n>Type of data compression | COMP. TYPE=3_ 
where <n> = O» ls 2» or 3 


0 


no compression. 


1 = no compressions but 
strip trailing blanks 


2 = compress two or more 
- blanks and strip 
trailing blanks 
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3 = alt of the above plus 
compress any occurrence 
of duplicate characters 
equal to or greater than 


COMPRESS ION.MIN 

COMPRESSION. . 

MIN=<n> — Number of consecutive COMPRESSION. MIN=4 
duplicate characters 
before compression 

- occurs. <n> = 2 to 31. | 

AUDIT © Open “OC/AUDIT.FILE* | No AUDITing 


at start of session 
and monitor data comm 


PARAMETER LIST ENTRY 


If the operator desires to override one or more of the default run 
time parameters» he enters either “R* or {Parameter Listl» in 
response to "USE DEFAULT PARAMETERS?”. | 


If the entry is through a (Parameter List] on the SPO» the operator 
can enter up to 72 characters to override the default parameters. 
If more characters are required» the operator must submit the 
parameter(s) through the card file labeled "HASP/PARMS®. 


If the entry is through the card files there may be one or more 
parameters per card and alt 80 columns of the card may be used. 
Howevers a parameter. must be contained completely on a card because 
there is no parameter continuation. . 


The parameter entry» whether from cards or SPO» is free form with 
the following exception: | 
Any parameter with an equal sign must: | 


ae) not have any imbedded blanks — 
be) be ended with a blank 


| | 1-17 
BURROUGHS CORPORATION , : COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP . B1700 HASP (Section I) 


SANTA BARBARA PLANT PeSe 2212 5256 


If an error is detected Cinvatid keyword or vatue) the. parameter 
scan is ended» the next 8 characters are displayed and the operator 
must correct the error and resubmit the entire list of default 
overrides again. 
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OPERATING INSTRUCTIONS 


At. the beginning of job HASP will set the run time parameters and 
verify that the data comm-control and bisynce adapter are present. 
Then HASP will wait for data set ready Calways present on teased 
tines present upon host answering call on switched lines) and then 
transmits a SOHENQ sequence. Upon recipt of an ACKO sequence’ fron 
the host» the message “COMMUNICATIONS ESTABLISHED” is displayed on 
the B1700 SPO. If the format of the signon messages remote ID or 
password is invalids the host will disconnect the remote. If the 
signon is corrects the B1700 and the host will go into a 
"handshaking" phase until either one has a data stream to transmit 
to the other. 


LOCAL COMMAND SUBMISSION 
To submit a command to the host HASP systems enter the following: 
<mix # of HASP>AX.Clocal command). 
Presently there are five local commands supported.— 
Cae) «SRI = Start Input Reader has four formats. 
1) SRI - SPOOL mode wilt cause transmission of “"HASP/CARDS" 


input spoot disk file. In DIRECT mode it will cause 
-transmission of *"HASP/CARDSIN®™ input card file. 


2) «SRL A = SPOCL mode will cause transmission of ‘input spool 
disk file labelled "A" «. In DIRECT mode it wilt cause 
transmission of input. card files» labelled "A*%.* _ 


3) .SR1 A/B = SPOOL mode will cause transmission of input 
spool disk file labelled “A/B” *. In DIRECT mode it wilt 
cause transmission of input card file “A/B". * | 
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(be) 


(ce) 


(de) 


Cee) 


&) SRL A/B/C = SPOOL mode wilt cause transmission of "B/C" 


from disk pack ltabelled "A" *. In DIRECT mode it. wiil 
cause transmission of “B/C" from disk pack tabelled "A". 
e 


* As B and C are character strings of 10 characters or less. 


eCLOSE = Close down system. «CLOSE will cause transmission of 
a /*SIGNOFF card and close down of system when current streams 
have compteted. 


e@NEW*SPOOL - If in SPOOL mode» ..NEW-SPOOL wilt cause the 


current output spool to be closed as soon as ait current 
output streams are finished and a new output spoot to be 
opened with anew namee <Any new. output streams will be 

suspended until a new output spoot is open. If in DIRECT mode 


“@NEW"SPOOL is an invatid local command. 


eAUDIT = If the data comm 1/0 monitor is auditing the data 
comm I/Q» .AUDIT will stop the auditing and close the audit 


file. 


If the data comm I/0 monitor is not auditing the data comm 1/0 
eAUDIT will open the audit file and start data comm I/0 
monitoringe © 


eJCLt .- Allows the remote HASP user to separate his JCL fron 


the data stream. «~JCLi can be used for any job that contains 
all necessary JCL pefore the data stream that is» multi-step 
jobs are prectuded unless the JCL for step 2 and further steps 
is included in the data stream. 


eJCLI opens a card file Labelled "HASP/JCL” that must contain 


att the necessary JCL for this job execution. End of file on 
“HASP/JCL™ will cause “HASP/JCL” to be closed and a card fite 
tabelled "HASP/CAROSIN™ to be opened. The - records in 
PHASP/JCL™ . and “"HASP/CARDSIN™ will appear as one contiguous 


‘card stream to the host. eJCLI is an invalid tocatl command 


when in SPOOL mode. 


Unless it appears somewhere within the “HASP/CARDSIN® file, 
the last JCL card in “"HASP/JCL™ must be? 
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S/NAME OD *® «© 


Alternate file names that are supported for .SR1i are not 
supported for -JCLi. 


eJCLI exampte: 


Given: 
ae)? JCL is a card deck. 
be) Data stream is a tape file. 


Place the following deck in the card reader: 


QDATA HASP/JCL 


fF mon eowmaemamaanm 4 


4 JCL CARDS 1! 


fg een ensanemae + : 


J/NAHE DD * 
ZEND 


Mount tape labetled “HASP/CARDSIN™. 
Enter the following tocat command: 
<mix # of HASP>AX.JCL1 
The cards in the card reader will be read and then the 


records on the tape will be read. All records will be 
sent to the host as one contiguous data streame 


Att SPO entries not beginning with a %.” are sent to the host for 
analysis and error reporting. 
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CHANGE FORMS PROCESSING 


In DIRECT mode when a special LOAD FORMS message is receiveds the 
HASP program will display the message and the host will wait for a 
start message signaling completion of forms change. 


When necessary forms have been changed (cards for punch)» the start 
message is as folttows: 
<MIX # of HASP>AXSSRM n>. PR1 Cor PU1) 
where <n> is the remote ID. 
In SPOOL mode when a special LOAD FORMS message is receiveds the 


HASP program writes the LOAD FORMS message to the output spool and 
generates the correct response to the host automatically. 
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SUMMARY STATISTICS REPORT 


When closing down the 81700 HASP/RJE sessions a summary statistics 
reports named HEREP CHasp Environment Recording Error Printout)» is 
printed. The format. of the HEREP report is: 


HASP ENVIRONMENT RECORDING ERROR PRINTOUT 


SD OR ED OO GEE 1 OEE DKBWEENE EE 8 BBEBOSBHRA LEDS OHA OD SESESBeE BS 


BLOCKS READ 


XXXXXXXX 


XXXXXXXX 


ERROR ID CUMULATIVE COUNT OF LAST SESSION 
BLOCK SEQ CK XXXKX XXX 
ERROR REPLY XXXXXXXX 
INVALID RESP XXX X XXX 
TOTAL LINE ERRORS XXX KK AAX 
TIMEOUTS — XXXXX XXX 
CRC XXXXX XXX 
OTHER LINE ERRORS XXXXX XXX 
NAKS RCVD XXKXXXXX 
NAKS SENT XXXXX XXX 
BLOCKS WRITTEN 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
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FILES 


Ie Common Files 
Parameter file = “PARMS®” Labeled “HASP/PARMS”« 
Record Size is 80. 
Blocking factor is ‘1. - 
Device: a.) If program switch zero is not set» 
device is disk. 


be) If program switch zero is set» 
device is card. 
co) If device is disk and file is not 


presents» device is changed to card. 


Audit File = “AUDIT™ tabeled "DC/AUDIT-FILE* 
Record Size is 180. _ 
Blocks per area is 10. 
Areas are 100. 
Device is random disk. 
The audit mechanism nay be started by entering AUDIT 
as a run time parameter or entering eAUDIT as a tlocat 
commande . 


“DBUGPRT® Labeted *DEBUG/PRINTER® 
Record Size is 132. 
Blocking factor is 1. 


Debug File - 


Device is printer. 
The debug mechanism may be started by entering 
“PROBLEM*™ as a run time parameter. 


WHEREP™ Labeled “HEREP/REPORT" 
Record Size is 132. 

Blocking factor is 1. 

Device is. printer or backup disk. 


Summary Results File - 


If. SPOOL Mode Files 

- "HASPIN® Labeled “HASP/CARDS". 
Record Size = buffer size. 
Blocking factor is le 
Device is disk. 


Input 
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Notes  Gperator may request “HASPIN® with another 
fabel by use of the .SRi filename tocal 
commande 


Qutput - “HASPOUT™ lLabeted "“HASP/PRINTO1". 
Record Size = buffer size. 
Blocking factor is 1. 
Device is disk. 


Notes: "HASPOUT” output spool #1 is labeled 
"HASP/PRINTOL™. Any subsequent spools» due to 
spool fitting completely or .~NEW"SPOOL local 
commands will be labeled “HASP/PRINT<nn>">» 
where <nn> is incremented by 1 =for each 
subsequent spool. 


Ill. DIRECT Mode Files 


Input ~ “HASPCARDS* Labeled “HASP/CARDSIN®™. 
Record Size is 80. 
Btocking factor is 1. 
Device is card. 


Notes: Operator may request “HASPCARDS” with another 
Label by use of the .SRL filename tocal 
' command. 


Output = *"HASPPRINT™ tabeled “"HASP/PRINT™. | 
Record size is print sizee — 
Blocking factor is 1. 
Device is printer or backup disk. 


"HASPPUNCH™ ‘Labeled “"HASP/PUNCH". 
Record size is 30. 

Blocking factor is 1. | 

Device is punch or backup diske 
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DYNAMIC MEMORY SIZE 


The HASP buffer sizes are determined by the run time parameter> 
Buffer=<n>» where <n> is the size of the tetleprocessing buffer 
declared in the host system. In order to accommodate alt 
installations» memory buffers are kept um a gunaats memory areae 
The dynamic size is computed by: 


CCBUFFER SIZE + 144608) + (BUFFER SIZE*CCQUEVE SIZE*2) + 3) #8) 


For any buffer size different from the default size of 400 bytes 
€3200 bits)» the HASP program must be modified via the HCP or 
executed with a memory statements i.@oep : 


2EX HASP 
PME=35648 


shore the ME statement ewettiss ene number of bits as computed 
above. . ; 


NOTE? In SPOOL mode whenever the dynamic memory size of HASP 
is changed» the dynamic memory size of HASP/SPOOL must 
be changed. Refer to HASP/SPOOL documentation for 

modifying of HASP/SPOOL. dynamic memory size. 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
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SPO MESSAGES 
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HASP has five types of SPO messages? 


(ae) INFORMATIONAL 
(be) PARAMETER ANALYSIS 


Cece) INPUT SPOOL ANALYSIS 


(de) ERROR 
Cee) HASP 


INFORMATIONAL MESSAGES 


Informational messages display the status of HASP. The following is 
a table of informationat messages: . 


Message 


RETRIES EXHAUSTED ON I/0 
ERRORS COUNTER REINITIALIZED 


RETRIES EXHAUSTED ON 
INVALID RESPONSES COUNTER 
REINITIALIZED 


NNNN SPOOLS TRANSMITTED 


READER 1 OPEN 


121 consecutive I/0 errors occurred 

and exhausted all retry counters. HASP 
continues to execute but the session 
Sshoutd be terminated and the connection ~ 
hardware checked. 


121 consecutive invalid responses were 
received. HASP continues to execute but 
the session should be terminated and the 
connection hardware checked. 


HASP displays the number of spools 
transmitted during the current SPOOL mode 
session. This message is displayed at 
end of job. 


HASP has opened the input spoot Cif 


-§POOL mode) or input card file if in 


DIRECT mode. 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


READER 1 CLOSED. 


<Filename> MISSING READER 
NOT OPENEO 
SPOOL WAS EMPTY 


-CAN*T SEND INPUT SIGNING 
OFF 
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HASP has sent an end of file message to 
the host system for the current input 
stream. 


Operator started reader while in SPOOL 
mode and the disk-file filename was not 
present. | 

The input disk spoot contained no records. 


Operator has attempted to start an input 


reader while HASP is signing off. 


PARAMETER ANALYSIS MESSAGES — 


PARAMETER ANALYSIS MESSAGES are messages displayed whenever an error 
is detected in analyzing run time parameter entry. | 


Message 


INVALID ID PARAMETER 


NO PARAMETER ENTERED 


INVALID ADDRESS PARAMETER 
INVALID BUFFER PARAMETER 


INVALID PRINTER PARAMETER 
COMPRESSION TYPE INVALID 


INVALID COMPRESSION MIN 


Reason 


Run time parameter for ID=<n> is not a one 
or two digit entry or is not followed by 


a blank. 


No entries on record in file “HASP/PARMS". 


Run time parameter for ADDRESS= is not 
in the form ADDRESS=P:C3As or the ports 
channel or adapter number is invalid. 


Run time parameter for BUFFER= is not in 
the range of 132 to 4095 or is not 
followed by a blank. ; 


Run time parameter for PRINTER= is not 
120 or 132. 


Run time parameter for COMP.TYPE= is not 


'Q» ly 2 or 3. 


Run time parameter for COMPRESSION.MIN= 
is not tin the range 2 = 31. 
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INVALID QUEUE PARAMETER Run time parameter for QUEUE= is not in 


the range 27 he 


XXXXXX INVALID PARAMETER Message is displayed upon detection 

PLEASE CORRECT AND RE“ENTER of first error in a parameter list. 
XXXXXX is invalid entry. Alt parameters 
must be re“entered. 


USE DEFAULT PARAMETERS? Request for run time parameter entry 
(see RUN TIME PARAMETERS? 


INVALID RESPONSE» TRY AGAIN “Neither “R™» “YES ™» parameter list 
. | nor /*SIGNON was entered in response 
to "USE DEFAULT PARAMETERS”. 


PARAMETER FILE ON OISK | "HASP/PARMS” disk file contained 
NOT VALID invalid parameter and will not be 
used for run time parameterse 


INPUT SPOOL ANALYSIS MESSAGES 


When the finput disk spoot is opened» the first record which contains 
the parameters with which the spool was created are compared to the 
current run time parameters and the fotlowing messages are 
displayed if any errors are detected: 


Message | Reason 
SPOOL HAS WRONG BUFFER - Spool was created with a different 
SIZE» FILE CLOSED buffer size than the current HASP 
buffer size. 

WARNING COMPRESSION TYPES The compression type of HASP is not 
ARE DIFFERENT the same as the spool. The spoot 

| is stilt transmitted to the host. 
WARNING SPOOL INDICATED HASP is executing in transparent mode 
NON=TRANSPARENT but the spool indicates nontransparent. 
TRANSMISSION ~The spool is stitéd transmitted to 


the host. 


BURROUGHS CORPORATION 
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WARNING SPOOL*S ID XX NOT 
THE SAME AS HASP ID Xx 
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The ID of the spoot does not match 
that of HASP. The spoot is stitt 
transmitted to the host. 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP. 
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ERROR MESSAGES 


Error messages are 
detected by HASP. 


Message 


‘ INVALID SPO MESSAGE 


displayed 
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whenever an operational error is 


Reason 


‘Operator entered an invalid locat 


SWITCHED ADAPTER BUT HASP 


CALLS FOR LEASED 


command. “.” must precede tocat 


commands » tcc exampte. 


HASP was executed with run time 
parameters indicating a teased line. 
Howevers the adapter was found to be 
strapped for switched line. The 


adapter must be removed and the 


LEASED ADAPTER BUT HASP 


CALLS FOR SWITCHED 


NON BISYNC ADAPTER 
NNNNNNN 


NO CONTROL PRESENT 


jumper chip changed. A Clear/Start 
is then required. 


HASP was executed with run time 
parameters indicating a switched 
line. Howevers the adapter was. 
found to be strapped for leased line. 
The adapter must be removed and the 
jumper chip changed. A Clear/Start 
is then required. | 


NNNNNNN is the adapter ID. Either 
the wrong adapter was used or the 
address of adapter was wronge 


HASP determined that there was no 
data comm controt at Specified 


-addresse 


INVALID PERMISSION TO 


SEND 


An invalid permission to send was 
received from the host. The 
permission to send is ignored. 
Permission was not itn response to 


‘request to senda 
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INVALID RCB An invalid RCB was received from 

the host. The block is discarded. 
DYNAMIC SPACE NOT LARGE The dynamic memory area was not large 


ENOUGH enough to hold the buffers. HASP is 
canceiled and the dynamic memory size 
must be corrected. 


ERROR: CONTROL BYTE The first record in the message blocks 

INVALIDs BLOCKED SKIPPED passed between the RTP and I0 procedures 
contains a control byte. Should this 
controt byte be invalid this message 
will be displayed and the block ignored. 


ERROR: ONLY ONE INPUT | Since multiple devices are not currently 
OR OUTPUT STREAM CURRENTLY. possible» should a block be received 
ALLOWED for anon supported devices this message 


is displayed and the block ignored. 


SEQUENCE ERROR ENCOUNTERED ALl message blocks passed between the 
CCOUNT) RTP and [0 procedures contain a sequence 
number. Should an out~of-sequence message 
block be detected» this message is 


displayed. | 

ERRORS ONLY ONE OUTPUT Message block contained a control 
STREAM ALLOWED» RECORD © byte for other than stream number i. 
SKIPPED | 
ERROR? INVALID “SRCB" Message block contained an invalid SRCB. 
RECORD SKIPPEO | . 
ERROR? INVALID SCB Length of SCB was greater than output 
LENGTH ENCOUNTERED record size. Onty portion of record 

. equal to record size is processed. 
INVALID MESSAGE LENGTH ALL message blocks have a tength fietd 
ENCOUNTERED . giving the length in bytes of the text 


in the block. Should this length be. 
greater than permitteds this message 
will be displayed and the permitted 
portion of the block is processed. 
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HASP MESSAGES 


Atl operator messages received from the host system are decompressed 
and displayed. These messages will always start with a *$". 


B1700 HASP OPERATING EXCEPTIONS WITH 360/20 


Te Channet Skips: . 

Not alt Burroughs* line printers are capable of handling a skip 
to channel 12. If such a skip is to be dones check to verify 
that this is possible on the system on which HASP is to be 

Tune 


II. File Closing: | | | 

| ~ HASP opens and Moses its output files many times within a 
session. Often an open is issued immediately after the fite 
has been closed» and the MCP has not completely closed the 
device. vhen this 1s the case» a message: 


"PRINTER OR BACKUP DISK REQUIRED FOR “HASP/PRINT<nn>* 


will be disptayed. When the device is fully closed» the file 
witl be automatically opened. Alt printer and punch files are 
declared optionally as disk backup. If the MCP “PBD®" option is 
set and above case occurs or output 1s directed by the NCP 
command "QU" to disks» all subsequent output wilt automaticatly 
go to disk backup. 
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GENERAL 


This section describes the use of a Burroughs B1700 as a HASP remote 
Stations i.@e» the HASP/SPOIL program and its use in the HASP 
environment. The HASP program was described in HASPC(Section I). 


SPOOL MODE 


SPOOL mode consists of three distinct phases. 


Phase #1 Input spoot creation Coff tine) with HASP/SPOOL. 
Phase #2 Input spool transmission and receipt of output spoot 
Con tine) with HASP. 
Phase #3 Output spoot printing and punching Coff tine) with 
HASP/SPOOL. ; 
NOTES "On tLine*™ is defines as? connected via data comm to the 
host HASP system. 


"off line” is defined as: no-connection with the host 
HASP system. 
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SPOOL Phase #1 


The input spoot is created off Line by HASP/SPOOL in order to reduce 
system requirements during the actual HASP/RJE session with the 
host. Cards are read» compressed» and blocked and stored in a disk 
file. Many card decks may be concatenated to form one input spool 
file. If more than one input spool disk file is to be transmitted 
during a sessions each must have a unique names The disk file 
created -by HASP/SPOODL is tabeliled “HASP/CARDS*. A subsequent 
execution of HASP/SPGQOL wilt create another file labelled 
“HASP/CARDS”. In order to have both files the first one must be 
changed from “"HASP/CARDS™ to another name. Refer to B81700'S06G for 
disk file tabet changing information. . 


SPOOL MODE 


SERRE wWAwt awe 


PHASE #1 INPUT SPOOL CREATION 


t 2 i 
| Mcp II | 
{ t 
1 4 | 
“HASP/CAROS” 1 . i “HASP/CARDSIN"® 
ke kekewk | Fer eenesroererey { Rkkkakkeakeek 
® & i i . Hy © * 
© DISK s<eereererrr= J HASP/SPOOL I<eerewewre= & CARD READER * 
* . fr | I t { * * 


kekkakank 1 Perm evewoeanewosy 1 
| ‘ 4 | 
{- { *@---+ 72 t 
' t->ESPOI>“+ ‘ 
( 7 
t ' 
+ + 


RRKEAERAKEHREAKEE 


BOO O28 OS C8 O28 BBS OSD OBSESLSDRBEe @ BS 
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SPOOL Phase #2 


Phase #2 consists of executing HASP» accepting appropriate run time 
parameters Crefer to RUN TIME PARAMETERS of HASPCSection 1)» 
establishing communications transmitting input spools» .and 
receiving output from the host system. After communication § is 
established» HASP signs on and enters a handshaking mode with the 
host. To-transmit an input spool files the operator starts an input 
‘reader by entering the Local HASP command <mix # of HASP>AXeS5R1 or 
<mix # of HASP>AX.SR1 <filename>s where <filename> is an optional 
name of the input spoot if the input spoot is not ‘labelled 
WHASP/CARDS".« 


After verifying that the input spool was created with the same run 
time parameters as HASPe a message is displayed “READER 1 OPEN” and 
the file is transmitted. After the file has been completely 
transmitted» HASP displays “READER 1 CLOSED". If another spoot is 
to be transmitted» the operator repeats the above procedure. 


Any output received during the spool-mode HASP/RJE session is 
written in its blocked and compressed form into the output spoot 
disk file HASPOUT. HASPOUT is initially labelled “HASP/PRINTO1". 
Whenever HASPOUT is closed and reopened during the HASP/RJE session 
Csee SPOOL MODE INPUT OPERATION of. HASPCsection. Id)» the label for 
HASPOUT is incremented by i. 


The operator may communicate with the host system by entering 
console messages to HASP. For examples <mix # of HASP>AXSDM» “THIS 
IS A MESSAGE* would cause HASP to transmit the entire string 
following the <mix #>AX until ETX #s encounterede Any SPO command 
whose first character is a %." is interpreted as a tocat command 
intended for HASP (see SPOOL MODE INPUT OPERATION of HASPCSection 
I1)). Phase #2 is terminated by enterning <mix # of HASP>AX.CLOSE on 
the console which causes HASP to sign off» close the output file 
and print a summary statistics report for this session. | 
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SPOOL MODE 


Phase #2 SPOOL TRANSMISSION 


t zs ‘ “HASP/CARDS* 
(  wcP II | RReRKKEK 
Rkkkkkey . | ¢ro~mr * 
kek t t § *« DISK * 
“Be SLC Seeseseso7 + t q * . « 
te k & aI 1 { § <wmwowmoesns kakekenkt 
wormaDa<em=>e5e OR I<m--=>f HASP/S 1 i 
\ *S* wY« i { SPOOL fwowoeoroerpe FHASP/PRINT™ 
sane wee aN« MLC 1 : Pern anaes ean 4 q { Rketkak kak & 
. «Cx i i #¢~---4 = | ft ¢e~>* DISK « 
xx q #=>USP01><—+ t * * 
kKkkkketky omens 4 * *. 
{ | REKKRAKRS 
ft | 
= BBWS V Ge G 28 2B et Eee as eaaunanane 4 


SPOOL Phase #3 


Phase #3 prints and punches data from the output spool file. The 
operator executes HASP/SPOOL and selects the output mode of 
operation. HASP/SPOOL reads the output spool disk fite catled 
"HASP/PRINTO1%s» debtocks and decompresses the records» and then 
prints or punches the output. This is all done off-line to tessen 
System requirements during the actual HASP/RJE session with the 
hoste 
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SPOOL MODE 


Phase #3 OUTPUT SPOOL PRINTING AND PUNCHING 


Se OD aD ES EF OS BEES MW BEHBEEMA EAR ABMS AMDS S&F SSN BMWAAB OBE Hee Oe 


Feaaaeawaowse 2 2 ee we an a oe 


( i 
f MCP II t WHASP/PRINT®™ 
{ ; te >aae akan 
“HASP/PRINT™ 2 t i * PRINT « 
tkknkkkaee q Fe oraeowneamons 1 { kkk hkkkKkkee 
* DISK wesce---=>1 HASP/SPOOL 1 i . 
Skenkkhe | PT wm emeeanoores { § *HASP/PUNCH® 
4 ¢ +t¢=-~-+ | | F@=2> eae keene 
{ #->ISPOl-->+ { * PUNCH * 
a guwey t Wek hkkkkik 
t | 


OTRECT MODE 


HASP/SPOOL program is only an off-line service program and does not 
execute in Direct Mode. Refer to HASP (Section I) for description 
of Direct Mode. - 
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SYSTEM REQUIREMENTS © 


The system requirements for B1700 HASP/RJE are specified in Section 
I of the HASP documentation. The minimum system for HASP/SPOOL are: 


MCPII 

32K Bytes Main Memory 

80= or 96-Colunn Card Reader 

120- or 132-Position Printer 

SPO | ‘c : | 
Disk (Cartridge Disk Pack or Head=Per=-Track) 
An 80= or 967Coltumn Card Punch in optional 


NOTE: IBM OS object code reading and punching is supported on 
— BO" and and 96-column equipment. 
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RUN TIME PARAMETERS 


Each remote 81700 HASP/RJE system witt have unique run time 
parameters» ieee» Duffer sizer» remote ID» compression types», etc. 
that are dynamicatly set at beginning of job. In the past’ these 
HASP variables were compiled into a remote program and any’ change 
in the remote necessitated a recompilation of the remote program. 


HASP/SPOOL requires knowledge of some of these parameters to create 
compatible spools for later transmission and to process spools from 
-@ previous HASP/RJE Session. 


HASP/SPOOL requires only a subset of the run time parameters 
required by HASP. For ease of operation» the same parameters» 
whether required by HASP/SPOOL or not» can be entered to HASP/SPOOL 
as to HASP. Unused parameters are syntax checked and then ignored. 


HASP/ZSPOOL has a tist of defautt run time parameters that. the 
operator can change or override at the start of HASP/SPOOL 
execution. 2 


At the beginning of job» HASP/SPOOL wilt interrogate program switch 
zero for a zero value. If a zero vatue is found (meaning. switch was 
not set by operator when executing HASP/SPOOL)» HASP/SPOOL witl 
attempt to read a disk file tabelled “HASP/PARMS”™ to obtain. the 
appropriate run time parameters for this execution of HASP/SPOOL. 
If the *HASP/PARMS™ file is founds the syntax of the parameters in 
the file are checked. If the parameters are syntax error. frees 
HASP/SPOOL sets a flag indicating parameters from disk were read 
and are valid. 


To bypass the search for the "HASP/PARMS™ fake on disk the operator 
should execute HASP/SPOOL as foltows: 


EX HASP/SPOOL SW 0 aF as 
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PHASP/PARMS” disk file can be created by “OMPALL™ or any suitable 
cardstosdisk program. Refer to PARAMETER DEFAULTS AND FORMATS for 
parameter defaults and formats. 


After HASP/SPOOL has determined the run mode for this execution of 
HASP/SPOOL (Refer to SP00L MODE OPERATING INSTRUCTIONS for 
operating instructions) and if any of the following occured: 


a>) SWO is setr a 
bd) “"HASP/PARMS* disk file not presents 
CC) “HASP/PARMS™ disk file contains an invatid parameters 


HASP/SPOOL will display the message: 
USE DEFAULT PARAMETERS? 


Run time parameter entry ‘occurs at this time. The acceptable 
responses to “USE DEFAULT PARAMETERS?* ares : 


- €mix # of HASP/SPOOL>AXYES "YES" means use of ali the default 
parameters. Refer to PARAMETER 
DEFAULTS AND FORMATS for defaults. 


<mix # of HASP/SPOOL>AXR "R*® means read run time parameters 
: from a card file “PARMS™ tabeled 
*HASP/PARMS™". Refer to PARAMETER LIST 

ENTRY for format of parameter file. 


<mix # of HASP/SPOOL>AX - {Parameter List} is a list of run 


CParamter List] time parameterse Refer to PARAMETER 
LIST ENTRY for format of parameter 
list. 

<mix # of HASP/SPOOL> “/eSIGNONese “is the exact format of 
AX/#SIGNONese | the first 72 columns of a signon card. 


This entry wilt override the defauit 
signon card and any IDs or /«*SIGNON 
found in subsequent parameter entry. 
After HASP/SPOOL entrys the operator 
can ‘continue with a YES» Rs» or 
UParameter List] response. 


If none of the above are entereds an "INVALID RESPONSE» TRY AGAIN® 
message will be displayed. 
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PARAMETER DEFAULTS AND FORMATS 


The table below tists all the defauit run time parameters. These 
parameters wilt be used if the reply in RUN TIME PARAMETERS is 
YES". Specific run time parameter defaults are overridden by entry 
of that parameter in the parameter list or by the presence of that 
parameter in the card file “HASP/PARMS™. Omission of a parameter 
causes the default to be used. 


Note: Default parameters should not be set. For: example: 
SPOOL» means SPOOL mode of operation and absence of 
SPOOL means DIRECT mode of operation. DIRECT is not a 
vatid parameter. ; 


RUN TIME PARAMETER DEFAULTS 


Parameter Meaning | . | Default 
*SPOOL SPOOL mode of operation DIRECT mode of 
operation 
*LEASED Leased Line Switched Line 
*PROBLEM Run with the DEBUG file Run with the DEBUG 
open — | . file closed. 

#/#STGNONewe Signon card image REMOTE1 with no 

password 


#10=<n> Remote*s ID» where <n> is a I0=1 
7 | one or two digit number. 
If the ID is only one 
digit» do not precede it 
with a lteading zero. 
Correct:. ID=1» 
Incorrect: [0=01 
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#* BUFFER=<n> Teteprocessing buffer size BUFFER=400 
where <n> is 3 or 4 digits 
from 132 to 4095. Note <n> 
must match the IP buffer 
Size of the host system 
and dynamic memory size 
must be changed if default 
is not used (See DYNAMIC 
MEMORY SIZE). 


aA 
PSCsa . Address of Bisyne Adapter ADDRESS=7212203. 
wheres . 


P=one digit port # (0-7) 


C=one or two digit channet 
F €0°15) 


=one or two ee adapter 
€ €0-715) 


Note? Ending colon is required. 
*NONTRANS Non-transparent text | Transparent text 


#*#PRINTER=<n> Printer Line size» where <n> ra us 132 
#s = 132 or 120. <n> must 
match stze of remote . 
printer line and generated 
size in host. 


*QUEUE=<n>. Number of buffers allowed © QUEVE=2 
to be internally queued 
before host is told to 
suspend transmission. <n> is 
a value from 2 to te 


weCOMP.TYPE=<n>Type of data compressions COMP. TYPE=3 
where <n> = 0» I» 2» or 3 


O=no compression 


l=no compression but strip 
trailing blanks 


2=compress two or more 
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blanks and strip trailing 
blanks 


Z=alt of the above ptus 
compress any occurrence of 
duplicate characters equal 
to or greater than 
COMPRESSION.MIN 


*AUDIT Open “DC/AUDIT.FILE* at. No AUDITing 
start of session and 
monitor data comm 1/0. 


a«COMPRESSION. ee ; . 
MIN=<n> Number of consecutive COMPRESSION.MIN=4 
duplicate characters before 
compression occurse 
<n>=2 to 3le 


*#Intly included to keep parameter file eouparibie with HASP Parameterse 
**Parameter is vital to HASP/SPOOL. 


PARAMETER LIST ENTRY 


If the operator desires to override one or more of the default run 
time parameters» he either enters R or (Parameter List] on the SPO> 
in response to *USE DEFAULT PARAMETERS*. 


If the entry is through a €Parameter List} on the SPO the operator 
can enter up to 72 characters to owerride the defauitt parameters. 
If more characters are required the operator must submit the 
parameters through the card file tabeted “HASP/PARMS”™. 


If the entry is through the card files there may be one or more 
parameters per card and alt 80 columns of the card may be used. 
However» a parameter must be contained completely ona card because 
there is no parameter continuatione 
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The parameter entrys whether from cards or SPOs is free form with 
the following exception: . 


Any parameters with an equal sign must 


Cae) not have any imbedded blanks 
Cb.) be ended with a blank 


If an error ts detected Cinvatid keyword or vatue) the parameter 
Scan is ended» the next 8 characters are displayed and the operator 
must correct the error and resubmit the ENTIRE list of default 
overrides again. : 
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SPOOL MODE OPERATING INSTRUCTIONS 


: HASP/SPOOL is executed by the operator. By the use of operator 
commands» HASP/SPOOL can perform the following functions: 


“4e Read a card fites compress it» build HASP transmission 
blocks and write these btocks to a disk file “HASP.OUT" 
labeled “"HASP/CARDS*. 


2e Read a disk file “HASP.IN"™ Labeled “HASP/PRINT<nn>*, 
decompress the disk file and print or punch the fites 
recordss where <nn> is O01 to 99. 


Upon executing HASP/SPOOL» the following messages wilt be displayed: 


SPOOLED MODE 

ENTER -SR1i FOR INPUT OR ~SP1 
FOR OUTPUT OR «BOTH FOR INPUT 
AND OUTPUT TOGETHER . 

ACCEPT 


The operator then enters: 
<mix # of HASP/SPOOL> 
ae eSR1I <filename> 


eSR1 is for reading an input card file and creating 
"HASP/CARDS™ disk spool. 


Filename is optional. When filename is not used the 
input card file opened will be Labeled “HASP/CARDSIN"™. 
If fitename is present the file opened wilt be tabeted 
<filename>. 


Filename can be of the foltowing formats: 
le A 


Ze AB 
3e A/B/C 
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Where A» B and C are chetacter strings of 10 or tess 
characters. 


be eSP1 <filename> 


eSP1 is for reading a HASP disk output spoot and 
printing or punching the recordse Filename is optional. 
Rhen filename is not used the spool file opened wili be 
labeled “HASP/PRINTO1%. If filename is present the 
spool file opened witt be labeled <filename>. 
<Filename> can be of the following formats: 


ie A 
Ze «=6ALB 
3e A/B/C 


Where A» Bs and C are characters strings of 10 or tess 
characterse 


' Ce BOTH 


BOTH is for reading a card fite tabeled "HASP/CARDSIN® 
and creating a spool file labeled "HASP/CARDS™ while 
reading a HASP output spool tabeled THASPELERTNT OLS and 
printing or punching the records. — 


‘There is no optional filename with BOTH. 


After the operator has correctly responded» HASP/SPOOL will test if 
run time parameters are already set from diske If not» HASP/SPOOL 
wilt display the following message: : 


USE DEFAULT PARAMETERS? 


Run time parameter entry occurs at this timee See RUN TIME 
PARAMETERS for explanation of run time parameters. 


SPOOL MODE OUTPUT OPERATION 


When HASP/SPOOL is executing in the output environment (€(SP1)» 
HASP/SPOOL . opens a disk file tabeled “"HASP/PRINTO1*% or optional 
“filename”. The first record of the file is a parameter record. 
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HASP/SPOOL compares its run time parameters with the parameters 
used to create “HASP/PRINTOL®. Should the differences between the 
sported file and HASP/SPOOL parameters be serious (for examples 
buffer size)» the program wilt print an error message and stope Any . 
nonsserious difference wilt cause a warning = HeS3 296 to be printed 
and HASP/SPOOL wie continue. 


After the parameter check HASP/SPOOL. starts decompressing and 
outputting the disk file. The disk file is read until end of file 
is detected and then closed. 


Should the special forms request message display? 
"JOB XXX LOAD XXX FORMS IN RM<ID>ePRI™ 


HASP/SPOOL will wait until the operator loads the special forms and 
answers with: | 


<mix # of SPOOL>AXSSRM<ID>-PR1 or 
<mix # of SPOOL>AXS$SRM<ID>.PUL 


depending upon whether a punch or printer request was seen. 


All other SPO messages received by HASP when the spool file. was 
being created will also be displayed. . 


SPOOL MODE INPUT OPERATION 


When HASP/SPOOL is executing in the input environment (.SR1)» 
HASP/SPOOL opens an output disk file tabeled "“HASP/CARDS* and = an 
input card file named “HASP/CARDSIN® or optionally “filename”. The 
card file is read until end of file is detected and then the = card 
fite is closed. Att card records are compressed» blocked and 
written to the disk files. subseauent. card files can now’ be added 
(see FILES). 
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END OF INPUT OR OUTPUY OPERATION 


When either the output mode detects end of file on disk spool or the 
input mode detects end of file on the card files the following 
messages are displayed on the SPO? 


END OF FILE» ENTER COMMAND 
ACCEPT 


The four vatid responses are: 


le <mix # of SPOOL>AX.SR1 <filename> 


AXeSR1 causes HASP/SPOOL to again open aecard file named 
"HASP/CARDSIN” or optionalty “filename™ and add it to the existing 
"HASP/CARDS”™ disk file. 


2e mix # of SPOOL>AX.SPi <filename> 


AXeSP1 causes HASP/SPOODL to again open. a disk fite named 
*HASP/PRINTO1"% or optionally "filename*. A parameter comparison 
test #5 made and the disk file is output. ; 


3. <mix # of SPOOL>AX.RS1I 


AXe%51 is an operator command to resume printing or punching a. 
spoole If during the execution of HASP in the spool mode the output 
spool file “HASP/PRINTOI" is filled with compressed datas that. file 
is closed and a new fite labelled “HASP/PRINTO2" is opened to 
receive the continuation of compressed datae At the end-.of the HASP 
session there will be two spool files» "HASP/PRINTO1" and 
"HASP/PRINTO2%. <mix # of SPOOL>AX.~RS1 can be used to output the 
continuation spool. 


NOTE? Continuation spools are maintained automatically until 
end of current session. 
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The following is an example procedure to follow in order to. 


the spool when the spool is contained in more than one fite. 


Te 


It. 


Ill. 


Bi700 HASP (Section II) 


output 


HASP fills the first disk area allocated to “HASP/PRINTOL® 


and the following messages are displayed: 


ENO OF OUTPUT SPOOL AT Csequence ‘#) - 
HASP/PRINTOL FULL = RESUMED AS HASP/PRINTO2.W 


HASP/SPOOL is mow executed by the operator with 
following displays and responses: 

SPOOLED MODE 

ENTER .«SR1- FOR INPUT OR .SP1 FOR OUTPUT.o~ 

ACCEPT 

LAXeSPi 

USE DEFAULT PARAMETERS? 

ACCEPT 

LAXYES 

ENO OF FILE» ENTER COMMANDO 


Now the operator can finish ei the spool with 
resume command:. 


LAXeRS1 


&e <mix # of SPOOL>AX-CLOSE 


eCLOSE causes HASP/SPOOL to close alt files currently open and 


end of job. 


These 


the 


the 


go to 


responses are la cerettned: when the “END OF FILE" message 
has been displayed. 
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oh 7 on 


Te SPOOL MODE FILES 


Input? 


Qutput: 


Parameter: 


“HASP. IN" ltabeted “HASP/PRINTO1® 
Record size = buffer size 
Blocking 1 record per block 
Device is disk 


"HASPCARDS™ tabeled “HASP/CARDSIN™ 
Record size = 8&0 

Blocking 1 record per block 

Device is card 


“HASPPRINT™ tabeted "HASP/PRINT®" 
Record size = print size | 
Blocking 1 record per block 

Device is printer er backup disk 


“HASPPUNCH™ tabeled “HASP/PUNCH® 


- Record size = 80 


Blocking 1 record per block 
Device is punch or backup disk 


“HASPeOUT" Labelled "HASP/CARDS® - 
Records size = Buffer size 
Blocking 1 record per block 


Device is disk 


“PARMS" Labeled "HASP/PARMS” 

Record size BO 

Blocking 1 record per block 

Device: a) If program switch 
zero is not Set» 
device is disk. 

b) If program switch 
zero is sets device © 
is card. 

c) If device is disk 
and file is not. 
present, device is 
changed to card. 
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DYNAMIC MEMORY SIZE 


The HASP/RJE buffer sizes are determined by the run time parameters 


BUFFER = <n>» where nis the size of the teleprocessing buffer 
declared in the host system. In order to accommodate att 
instatlationss memory buffers are kept in a dynamic memory area. 


The dynamic size is computed by: . : 

(Cbuffer size) * 2) * 8 = # of bits required 
‘For any buffer size different from the defautt size of 400 bytes 
€3200 bits)» the HASP/SPOOL program must be modified via the MCP or 
executed with a memory statementer ieee» 


2EX HASP/SPOOL 
2ME=6400 


where the ME statement specifies the number of bits as computed 
above. 
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SPQ MESSAGES 


HASP/SPOOL has four types of SPO messages? 
ae OPERATIONAL 
be PARAMETER ANALYSIS 


Ce INPUT SPOOL ANALYSIS 
de ERROR 


OPERATIONAL MESSAGES 


OPERATIONAL MESSAGES that require a response from the operator to 
direct the further operation of HASP/SPOOL. 


Message Reason Response 


SPOOLED MODE. ‘Run Mode None 

ENTER «SR1 FOR INPUT -SR1 Request - - $ee SPOOL MODE OPERATING 
FOR OUTPUT OR BOTH FOR : INSTRUCTIONS 

INPUT AND OUTPUT TOGETHER | | 

END OF FILE» ENTER Input card file See END OF INPUT OR 


COMMAND or input spoot § OUTPUT OPERATION 
EOF detected 


PARAMETER ANALYSIS MESSAGES 


Parameter analysis messages are. messages displayed whenever an error 
is detected in analyzing run time parameter entry. 


BURROUGHS CORPORATION 
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Message 


INVALID ID PARAMETER 


NO PARAMETER ENTERED 


INVALID ADORESS 
PARAMETER : 


INVALID BUFFER 
PARAMETER 


INVALID PRINTER 
PARAMETER 


COMPRESSION TYPE 
INVALID 


INVALID COMPRESSION 
MIN 


INVALID QUEUE 
PARAMETER 


XXXXXX LNVALID 
PARAMETER» PLEASE 
CORRECT AND RE“ENTER 


USE DEFAULT PARAMETERS? 


INVALID RESPONSE» TRY 
AGAIN 


PARAMETER FILE ON DISK 
NOT VALID 
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Reason 


Run time parameter for ID= is not a one 


or two digit entrys or is not followed by 


a blank. 
No entries in record in file 
"WHASP/PARMS™. 


Run time parameter for ADDRESS= is not 
in the form ADDRESS=P2C2A2 or the port» 
channel or adapter number is invalid. 


Run time parameter for BUFFER= is not 
in the range of 132 to 4095% or is not 
followed by a blank. ; 


Run time parameter for PRINTER= is not 


120 or 132. 


Run time parameter for COMP.TIME= is 
not O» il» 2s or 3. 


Run time parameter ‘for COMPRESSION.MINE. 
is not in-the range 2 - 31. 


Run time parameter for QUEUE= is not . 
in the range 2 - 4. 


Message is displayed upon detection of 
first error in a parameter tist 
XXXXXX is invalid entry. ALL 
must be re-entered. 


parameters 


Request for run time parameter entry (see 
RUN TIME PARAMETERS). 


Neither "R%» *YES"%» (Parameter Listi nor 
“eSIGNON was entered in Fespionss to “USE 
DEFAULT PARAMETERS”. 


“HASP/PARMS® - disk file contained invalid 
Parameter and will not be used for run 
time parameters. 
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INPUT SPOOL ANALYSIS MESSAGES 


When HASP/SPOOL is executing jin the spool output modes the 
"HASP/PRINTOL" disk spool is opened and the first record which 
contains the parameters with which the spoot was created is read. 
These parameter are compared against the current = run time 
parameters and if an error occurs one or more of the following 
messages: are disptayed: 


Message Reason 
ERROR? "BUFFER™= Current size of HASP/SPOOL buffer does 
PARAMETER DCES NOT not match spoot buffer size. Correct 
AGREE WITH SPOOL .= and re-execute 
programe 
ERROR: *COMP.TYPE™* Current COMP.~TYPE of HASP/SPOOL does 
PARAMETER INVALID not match COMP.TYPE of spool. 


ERROR? “COMPRESSION. MIN™ Current COMPRESSION.MIN of HASP/SPOOL 
PARAMETER INVALID does not match COMPRESSION-MIN of spool. 


ERROR MESSAGES 


Error messajes are displayed whenever an operational error is 
detected by HASP/SPOOL. . 


Message Reason 

ERROR? CONTROL BYTE The first byte of a record to or from 

INVALID» BLOCK SKIPPED HASP/SPOOL is a control byte. Shoutd it 
be invalids» this message will be 


displayed and the block ignored. 


ERROR: ONLY ONE INPUT Since muttiple devices are not currently 
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OR GUTPUT STREAM 
CURRENTLY ALLOWED 


SEQUENCE ERROR 
ENCOUNTERED Ccount) 


- ERROR: ONLY ONE OUTPUT 
OR OUTPUT STREAM 
CURRENTLY ALLOWED 


ERROR? INVALID "SRCB">» 
RECORD SKIPPED 


ERRORS INVALID SCB 
LENGTH ENCOUNTERED 


INVALID MESSAGE LENGTH 
ENCOUNTERED 


INVALID “"RCB” DETECTED» 


BLOCK SKIPPED 


ERROR? SPOOL FILE EMPTY 


INVALID RESPONSE 


invatid 
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possible, should a btock be received for 
an additional devicer this message is 
displayed and the block ignored. 


ALl message blocks in the spoot are 
internally sequenced. Should a block be 
losts this message is displayed along 


with the sequence count of expected. The 


block is unpacked and output. 


Message block contained a RCB for 

other than stream number 1. © 

Blocking is skipned an the first portion 
tis output on the SPO. 


Message block contained an invalid 
SRCBe =s 


Length of SCB was greater than output 


record size. Only the portion of the 
record equat to output record size is 
processed. 


All message blocks have a tength field 
Qiving the length in bytes of the test in 
the block. Should this langth be greater 
than permitteds this message is disotayed 
and the permitted portion of the block is 
processed. | 


HASP/SPOOL detected an invalid RCB; 
the block is ignored. 


The input spoot contains no records. 


This message will be displayed for any 
response to an ACCEPT condition. 
The program wilt then wait for another 
input messagee 
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GENERAL 


TEST8SC is a 81700 SDL program written to exercise and verify the 
quality of a Binary Synchronous (€8SC) Line between ai Burroughs 
B1700 computer with a Single Line Controt (C(SLC) or Multi-Line 
Controt CMLC)» using the Burroughs BSC EBCDIC line adapters and an 
ISM computer with a compatible Binary Synchronous Control. 


TESTBSC requires a Burroughs-written 360/370 OS BAL program named 
BURRBSC to be executing in the IBM computer. See technical 
documentation of BURRBSC» HASPCsection IV)» for a description of 
the host program. 
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OPERATION 


TESTBSC can run in one of four modes: 


(1) Leased transparent) 

(2) Leased non-transparent 
3) Switched transparent 
(4): Switched non-transparent 


TESTBSC makes the connection with the IBM computer Cdependent = on 
leased or switched) and transfers 256 messages to the IBM computer 
which will echo the message back. The format of each message is 
different and allt possible bit configurations are transmitted. The 
echoed. message is compared to the transmitted message and any 
noncompares are toggede 


After 256 messages have been successfully echoed or error retries 
are exhausted» TESTBSC prints the results of the test and goes to 
end of job. a 
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OPERATING INSTRUCTIONS 


RUN TIME PARAMETERS 


After execution of TESTBSCs the following messages will be output to 
the SPO. 


USE DEFAULT PARAMETERS? © 

TESTBSC is asking whether to use the default parameters 

SWITCHED 

TRANSPARENT 

ADDRESS 7321230: 

or to use the parameters entered through the SPO or via a card file. 
To use the default parameterss reply: <MIX # OF TESTBSC>AXYES.~ 
To override a default» enter <MIX # OF TESTSSC>AXCParameter List} or 
<MIX # OF TESTBSC>AXR where (Parameter List] is a free form List of 
parameters» and R signifies that the parameters are in a card file 
labelled “"HASP/PARMS". Valid parameters are: 

LEASED for teased tine | 

NONTRANS for nontransparent 


ADDRESS=P3C3Aas for address of adapter where 


P = 1 digit port number 

C = 1 or 2 digit channet number 

A = 1 or 2 digit adapter number 
EXAMPLES 


<MIX # OF TESTBSC>AX LEASED 

<MIX # OF TESTBSC>AX NONTRANS LEASED 

-€MIX #£ OF TESTSSC>AX ADDRESS=7212303 LEASED NONTRANS 
<MIX # OF TESTBSC>AXR | 
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If an invatid parameter ts entereds an error message wilt be 
displayed containing the first 8 bytes of the parameter in error. 
The operator can correct the error and reenter YES» (Parameter 
List) or R. 


To be compatible with the HASP/RTP programs the same HASP/PARMS card 
file can:be used. Unused parameters including the /*SIGNON card are 
-tonoreds. | 


After successful parameter inputs the line is broken if it is a 
switched tines then the presences of the adapter and the control is 
checked and the strapping option of the adapter is verified to be 
the same as specified Ceither LEASED .or SWITCHED). Appropriate 
error messages are displayed. 


If the proper hardware is ready and the connection is a LEASED line» 
then one of the following messages will be arsotayeds 


C1.) BURRBSC TEST 2 MUST BE RUNNING IN IBM COMPUTER 
for transparent data or 


C20) BURRBSC TEST & MUST BE RUNNING IN IBM COMPUTER 
. for non-transparent data. 


If the connection is a switched Lines one of the following messages 
will be displayed: 


Cie) DIAL IBM COMPUTER WITH BURRBSC TEST 2 RUNNING 
for transparent data or - 


2.) OAL IBM COMPUTER WITH BURRBSC TEST 4 RUNNING 
for non-transparent data. 
After connection has been made the following message witt be 
displayed: 


CONNECTION MADE 
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After the connection has been established» TESTBSC will send an SOH 
ENQ sequence to BURRBSCs» which will respond with an ACKO. 


If there is no reply to the SOH ENQ sequence and the connection is 
leased» an error message is printed. On both leased and switched 
lines, the retry counter is decremented and tested. If the retry 
counter is not zeros the SOH ENO is retransmitted. If the retry 
counter goes to zero before receiving a valid ACKOs TESTBSC wilt 
print summary results and go to end of job. 


TEST TRANSFER 


Text transfer starts after connection has been made and an ACKO 
received to the SOH ENQ sequences The test buffer will be of two 
formats. 


Transparent - all 256 possible bit patterns. 
Non-transparent -* 256 characters with Hex 00°3F having the 


most significant bit on to avoid being a line 
control character. 


‘Before transmissions the text buffer is rotated. 


Upon completion of the transmission and the following read for the 
echoed responses» the I/0 operation is tested . for errors. If an 


error is detected» the error is togged on the printers the error 
retry counter is decremented and tested. If the retry counter is 
zeros the summary results are printed and TEST8SC goes to end of 


job. If the retry counter 15 not zero» the tast message is 
retransmitted. : 


If no line error was detected» the read buffer is tested for a NAK 
and if a NAK was receiveds the NAK is Logged on the printer and the 
last message is retransmitted. 
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If completion is good and a NAK was not received the received data 
is compared to the transmitted data. If. a compare error is 
detected» an error message is printed» the . retry counter 
decrementeds and the last message retransmitted. 


If the received and transmitted data compare then the text buffer is 
rotated one position so that each of the 256 messages transmitted 

wilt be different and the end of messages condition is tested. If 

not end of messages» the next text buffer is transmitted. If end of 

messagess a OLE EOQT is sent to tett BURRBSC that the test is 

complete. TESTBSC then prints the test results and goes to end of 

job. 
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Message 


READ TEXT ERROR 

SEND ENQ ERROR 

RESULT DESCRIPTOR ONE Nes-N- 
RESULT DESCRIPTOR TWO NeeeN 


READ EXCEPTIONS 
WRITE EXCEPTIONS 


‘CRC ERROR 

READ MEMORY ACCESS ERROR 
WRITE MEMORY PARITY ERROR 
TIME OUT ERROR 

| BREAK RECEIVED OR DETECTED 
NO ENDING CONTROL DETECTED 
LOSS OF DATA SET READY 
LOSS OF CLEAR TO SEND ON 
WRITE OR LOSS OF CARRIER 
ON READ 

WRITE BUFFER 

READ BUFFER 

READ OF DID NOT COMPLETE 
NO DATA RECEIVED 
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Meaning 


1/0 exception during message transfer 


1/0 exception during Inquiry 


First result descriptor - Write Qp 
Second resutt descriptor - Read Op 


Read Op failed - reason follows 
message 


Write Op faited = reason follows 
message 


Exception 
Exception 
Exception 
Exception 
Exception 
Exception 
Exception 


Exception 


Write buffer follows in Hex 


Read buffer fottows in Hex 


“No read buffer because Write Op faited 


No data read into receive buffer 
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RESULT MESSAGE 


At end of job the following message wit be printed. 
B1700 BSC LINE VERIFICATION RESULTS 
1 


SHITCHED { 

> LINE. 
LEASED 4 

{ 


mam A a om 


TRANSPARENT 
TEXT 
NON“TRANSPARENT 


naam A a on 
ana VY ob ap 


ADDRESS = P:C2A2 

NUMBER OF SUCCESSFUL MESSAGES ECHOED nnnn 
NAKS RECEIVED nannn 

CRC ERRORS nnnn 

TIME OUTS nnnn 

OTHER LINE ERRORS nannn 


DATA COMPARE ERRORS nnnn 
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Message 


DIAL IBM COMPUTER WITH 
BURRBSC TEST 2 RUNNING 


DIAL IBM COMPUTER WITH 
BURRBSC TEST 4 RUNNING 


BURRBSC TEST 2 MUST BE 


RUNNING IN IBM COMPUTER 


BURRSSC TEST 4& MUST BE 


RUNNING IN IBM COMPUTER 


SWITCHED AOAPTER BUT TEST 


CALLS FOR LEASED 


LEASED ADAPTER BUT TEST 


CALLS FOR SWITCHED 


NON BSC ADAPTER NNNNNNN 
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Meaning 


OR REG aE aaa 


TESTBSC was executed with the switched 
fine and transparent options. The 
compatible host test is BURRBSSC Test 2. 
Operator must now manually dial host. 


TESTBSC was executed with the switched 
tine and non-transparent options. The 
compatible host test is BURRBSC Test 4. 
Operator must now manually dial host. 


TESTBSC was executed with the leased 
dine and transparent optionse The 


compatible host test is BURRBSC Test 2 


which must be running or after 11 
consecutive line errors TESTBSC will 


abort. 


TESTBSC was executed with the leased 
line and non-transparent options. The 
compatible host test is BURRBSC Test 4 
which must be running or after ii 
consecutive line errors TESTBSC witl 
abort. | | 


TESTBSC was executed with the leased 

line option but the adapter was found 
to be a “switched” adapter. TESTBSC 

wilt abort. _ 


TESTBSC was executed with the switched 
Line option but the adapter was found 
to be a “leased” adapter. TESTBSC will 
abort. . 


The adapter was found not to-be the 
EBCDIC BSC line adapter. NNNNNNN jis 


“the ID of adapter founde TESTBSC will 


abort. 
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ERROR RETRIES EXHAUSTED 
ON & BREAK ' 

! SEND ENQ ¢ 

§ READ TEST 


USE DEFAULT PARAMETERS 


XXXXXXXX INVALID PARAMETER 
CORRECT AND RE@ENTER 


NO PARAMETERS 
ENTERED 
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Error retry counter reached zero. 

Seven consecutive errors were detected 
on all operations except send SOH ENQ 
where the count is 11. Summary resutts 
wilt now be printed and TESTBSC with 
abort. 


TESTBSC is asking operator whether or 
not to use the default parameters. 
Correct responses are: 

“YES*» use defaults 


"R™»s parameters are in card file 
Labelted HASP/PARMS 


(Parameter List] List of parameters. 


 TESTBSC parameter analysis found an 
-ainvalid parameter. XXXXXXXX is the 


first eight characters of the parameter 
detected as invatid. This message is 
printed as the first invalid parameter 
in a card image or SPO entry is 
detected. Subsequent parameters on 
that card image or SPO entry are not 


‘checked. The operator at this time 


has the same options as to the 


response of "USE DEFAULT PARAMETERS". 


For a card fite each card image is 
analyzed before operator is given a 
chance to correct the invalid parameters. 


It is important to note that alt 
parameters must be re~entered and 
not just the corrected invalid 
parameter. 


_TESTBSC parameter found no parameters 


in the card image or SPO entry. 
Operator now has the same options as 


to the response to "USE DEFAULT 


PARAMETERS". 
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ENTER OTHER PARAMETERS 
OR YES FOR DEFAULTS 
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The first SPO entry was a “SIGNON*". 
Operator now has the same options as 
to the response to “USE DEFAULT 
PARAMETERS". 
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GENERAL 


BURRBSC ts a dtagnostic program designed to perform two functions: 


ae 


be 


To aid Burroughs field engineers using the 81700 diagnostic 
850/53 in the installation and maintenance of an EBCDIC binary 
Synchronous connection between a B1700 used as a remote 
terminal and an IBM 360/370 HASP/RJE host. . 


To be a responder to the B1700 binary synchronous” line 
verification programs TESTSSC. TEST8SC and BURRBSC can be used 
to verify the operation of the binary synchronous hardware 
Cadapterss controls» modems» lines) before a HASP/RJE session. 


BURRBSC is designed to run in the host 360/370 under the 18M 
Operating System €0S) environment to minimize system interference 
at the IBM System 360/370 site. | 
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DESCRIPTION OF TESTS 


BURRBSC will act as a responder to messages received from either 
Burroughs Fietd Engineering diagnostic 85C/5.3 or Burroughs tine 
verification programs TESTBSC. Refer to the documentation of 
BSC/5.3 or TESYBSCs» HASPCsection III) for a description. of 
operating instructions for these two programs. 


“ BURRBSC consists of a series of tests that can be run individually 
or sequentially. The tests are designed to check allt aspects of 
binary synchronous transmission protocol as used with the HASP/RJE 
systeme 


The foltowing is a tist of all corresponding tests between BURRBSC 
and the B1700 programs 8$C/5e3 and TESTBSC: 


BURRBSC BSC/5-3 © TESTBSC 


02 i _ Transparent Mode 

04 | ) _ . Non Transparent Mode 
06 | 5 N/A 

12 oe (1 #2 +¢ 5) | | N/A 


INITIALIZATION OF TESTS 


ALL tests start with the following channel program to receive the 
bid (SOH ENQ) from the 81700: 


OISABLE 
SET MODE 
ENABLE 


READ 
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If a timeout occurs at the READ commands the channet program is 
restarted at the READ command with no error messagee Timeouts 
waiting for SOH ENQ are not considered line errors by HASP/RJE} ALL - 
other line errors are reported and the channet program is restarted 
at the DISABLE command. Ail non-timeout errors are retried until 
the error retry Limit is reached. When the Limit is reached the 
test ts ended with an error message to the operator. 


TEST ECHO PHASE 


After the initialization phase» all tests will respond ACKO to the 
SOH ENQ and begin echoing received text. The type of echoing by 
test is as follows: : : 


Test 02 Echoes Transparent Text 

Test 04 Echoes Non Transparent Text 

Test 06 Echoes with a 2 eecona dakay and then ACKO 

Test 12 : ae a sequential execution of test» 025 04 and 


Each test wilt run until a DLE E0T sequence is received from BSC/5.3 
or TESTBSC in the 81700. This allows the Burroughs 81700 program to 

determine the tenath of time for each test to run. In addition the 

message length and content will be selected at the B1700 computer. 

For BSC/5e3% the length will be selected at run time and may vary 

from 10 to 400 bytes. The data witt be selected at run time and may 

be either "canned*™ messages or user specified. For TESTBSC» a 259 

byte test buffer wilt always be received. The buffer will contain 

3 data link controt characters and 256 non-transparent or 

. transparent text bytes. 
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TEST ENDING PHASE 


Alt tests wilt continue to echo received text until a OLE EOQT 
sequence is received. At that time the test will end. If -the 
selected test was test 12 (run all tests sequentially)» and the 
last test was not Test 06» then BURRBSC will step to the next test 
€04 or 06)» bypass the DISABLE» SET MODE and ENABLE and issue the 
READ command to wait for the next bid (SOH ENQ). 


TEST ERROR RECOVERY 


/ 


Error recovery procedures are designed to be similar to those used 
by HASP/RJE system with a few changes to facilitate the diagnosing 
of tine errors. The main change is the addition of an extensive 
printout for each tine error detected. The error printout is 
described in I/0 errors printout. 


The basic error recovery philosophy is to tog any error and then 
write a NAK chained to a read text commande. There are two 
exceptions to this: | 


"ae If a timeout occurs during the initialization phase no error is 
logged -and only the read command is reissued. This is to 
prevent excessive togouts while waiting for the SOH ENQ from 
the B1700. | 


be If a NAK is receiveds the NAK is’ logged and the last message is 
retransmitted. This will prevent a NAK“NAK loop between the two 
programs. , 


After each error is logged the retry limit is tested to see if the 
consecutive number of errors detected is equal to the Limit. If the 
limit is reacheds the operator is notified by an error message _ on 
the console typewriter and the test is ended. The retry Limit is 
Paymaster lees after each successful reception. 
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OPERATING INSTRUCTIONS 


BURRBSC will be eo vescee as a source deck that must be assembled and 
linked prior to execution. 


ASSEMBLING AND LINKING BURRBSC 


Prior to assembling BURRBSC» proper JCL information must be obtained 
from the I8M site's system programmer to insure the JCL meets all 
the unique specifications for that installation. The following JCL 
is a sample of the JCL needed to assemble and link BURRBSC into 
SYSLeLINKLIB COS normal execution library). The punching of JCL 
cards must start on column one (1) of the card. : 


S/ASEM JOB MSGLEVEL=1 


/7K EXEC ASMFCLSASM. PARM= *NODECK® 
/TKSMeSYSIN DD# 


NAME BURRBSCCR) 
f* 


EXECUTION OF BURRBSC. 


The following is an example of JCL required to execute BURRBSC. 


4/BSC JOB MSGLEVEL=1 

SFA EXEC PGM=BURRBSC 
/J/SYSPRINT DD SYSOUT=A_ CA) 
47TCOD DD UNIT=XXX (B). 


CA) UNIT=XXX CXXX=UNit Address) may be substituted for SYSOUT= ne if 
a printer is available for direct allocation. 
(83) XXX in UNIT=XXX is the address of Line to be tested. 


4-6 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP B1700 HASPC(Section IV) 


SANTA BARBARA PLANT Pe Se 2212 5256 


TEXT. EXECUTION. 


After the program has started it will display on the system console 


BURRBSC BURROUGHS 381700 TO IBM BISYNC TEST 
XX BURRBSC = ENTER TEST REQUEST 


To start a test reply in the following manner: 


r XXe*t/mamep/y or n? 


t/mm is the only required parameters where mm is the two digit test 
number. p/y or nis optional and specifies whether error printouts 
will be printed Cy) or not (nd. The default is p/y Cprint errors). 
Hhen the selected test has completeds the test request message wilt 
be repeated to allow the operator to enter another test request or 
terminate the programe. 


TEST TERMINATION 


To terminate BURRBSC reply "rFXX»*end**™ to. any test request message. 
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BURRBSC CONSOLE MESSAGES 


Message 


BURRBSC-ENTER TEST 
REQUEST 


BURRBSC LINE 
OPEN ERROR 


INVALID PARAMETER@= | 


TRY AGAIN 


INVALLD TEST- 
TRY AGAIN 


1/0 ERROR 
STATUS XXXX 
SENSE YY 


NO TEST PARAMETER= 
TRY AGAIN 


PRINTER OPEN 
ERROR 


TEST STARTED 


TEST ENDED 
XXXXXXXKXK 
MESSAGES | 
TRANSFERRED 


Meaning 


To enter next test 


request or “end”. 


‘Error occurred on open 


macro for the tine. 


Invalid parameter 
entered on test 
requeste 


The test parameter was 
not a valid test 
numbere 


A permanent I/0 error 
occurred on the line. 


A test request was 
made without a T 
parameter. 


Error occurred on open 
macro for the printer. 


A valid test request 
was received and the 
test has been started. 


The requested test 
ended either normally 
or abnormally. . 
XXXXXXXXXX is the totat 
Number of messages 
echoed by the program. 


Action 


ee ae Re oe 


Enter appropriate 
request. 


Line labeled TCDD 
Check parameters and 


re~enter request. 


Check test number and 
rem~enter. Test must be 
two digits. 


Nones program wilt 
terminate current test 


and issue new test request 
message 


Check request and 


re-enter. 


Check specifications 
on OD card tlabeted 
SYSPRINT. 


None 


None 
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BURRBSCn.- Test start up maessage.n None 

BURROUGHS 81700 is the level number of 

TO IBM BISYNC BURRBSC. 


TEST 
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1/0 ERROR PRINTOUT 


The fottowing is an explanation of the printout assccvared wich each 
error detected. 


1/0 ERROR FAILURE = XXXXXXXXX 
XXXXXXXXX is an English representation of the sense information. 
SENSE = XX | 


XX is the sense byte from the I0B. See appropriate IBM manual 
for specific bit meanings. 


STATUS = XXXX 


XXXX are the status bytes from the CSW. See appropriate I8M 
manuals for specific bit meanings. 


ECB = PAAEEARES 


XXXXXXXXX is a standard OS event control biseke. See appropriate 
IBM manuals st meaning. 


CSW = XXXeeeXXX 


~XXXeeeXXX is the channet status word from the IOB. See 
speroprvate IBM manuals for meaning. 


CHANNEL PGM ADDRESS = XXXXXXXXX 


XXXXXXXXX is the address of the first CCW executed in the tast 
1/70 operation. See CHANNEL PGM = below for actual CCWts. 


FAILING CCW ADDRESS =. XXXXXXXXX 
XXX XXKXX is the address of the CCW that fatled in the tast I70 


operation. Use this field with the previous fieid to find the 
failing CCW in the CHANNEL PGM = field below. 
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FLAGS = AABBCCDD 


AABBCCDO are the flag bytes used by the programe They are 
defined below with bits numbered from left to right (0-7). 


FLAG 1 = AA BIT USE CIf On) USECIf Off) 
0 Test started No test entered 
1 Print negated Print is on 
2-7 Not used 


FLAG 2 = BB Test number in Hex. 


FLAG 3 


it 


cc 0 Enable Mode 

1 Response Node 
2 Text Mode 

3 End Mode 

4 ; Error Mode 

Fa a Not used 


| (FLAG & = OD oo if test 2» 4 or 6 
*oc7* if test 12. See flag 2 for 
actual test number. 


MSG - COUNT 


XXXXXXXX 


XXXXXXXX is the number of messages echoed before the error 
occurred. — . 


XXXeeeXXX is the actual channel program. executed on this 170 
operation. See channel PGM ADR & FAILING CCW ADDRESS fields for 
more information. 


WRITE BUFFER 


The first byte of the next line is the beginning of the contents 
of the write buffer of the Last write command. This field may 
be empty on a single read command failure. 


READ BUFFER 


The first byte of the next line is the beginning of the contents 
of the read buffer of the last read commande If the I/0 error 
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occurred on awrite command or no data was receiveds then this 
field wilt be empty. 
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